home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga3 / plfuti20.lha / PLFUtil / docs / FileSort.doc next >
Text File  |  1993-11-20  |  3KB  |  88 lines
  1.  
  2.                      Filesort v1.01  for TransAmiga BBS
  3.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.                        Copyright ⌐1993 by Rod Schnell
  5.  
  6.  
  7.   A fast executable command to sort TransAmiga file lists in 4 different ways
  8.  with  natural or reverse  ordered output.  FileSort  version 1.01  now keeps
  9.  comments  (lines beginning  with a backslash).  The comments are  considered
  10.  to be an extended description for the  file above.  Any number of additional
  11.  eighty character lines (tested with over 100 lines) may be used in this way.
  12.  TransAmiga allready displays these escape lines so it works quite well. For
  13.  asthetic  purposes it is  best  to use  spaces for the first 39  charachters
  14.  in extended description lines.  A header comment for each list is  supported
  15.  and it too may be any number of lines in length.
  16.  
  17.  ** Important Note **
  18.  
  19.   GTAFDL  does not  support comments  embedded in the file lists.  If you use
  20.  "\"  comments  (or  extended  descriptions as  Filesort treats them)  GTAFDL
  21.  will delete  everything in the list from the comment line to the end. If you
  22.  wish to use comments don't use GTAFDL.
  23.  
  24.  
  25.   Filesort was written because I wanted a faster method of sorting file lists
  26.  with the newest files at the top of the list. While writing Filesort I added
  27.  other sort methods as well.  I will continue adding new options and features
  28.  until the execution speed begins to suffer.
  29.  
  30.   This program is not Public Domain, I retain all rights. It is however freely
  31.  redistributable.  Filesort may not be  included with any  commercial software
  32.  package without my express written consent.  No fee other than a minimal disk
  33.  copying fee (no greater than that for Fish Disks) may be charged for Filesort.
  34.  
  35.   No  guarantees  either  written or  implied are given for the performance or
  36.  suitability of Filesort in any way.
  37.  
  38.  
  39.  
  40.  
  41. Using Filesort
  42. ~~~~~~~~~~~~~~
  43.  
  44.        Usage: FileSort inputpath [outputpath] [sortmethod] [reverse]
  45.  
  46.  sortmethods: a = by alphabetical name
  47.               d = by file date
  48.               s = by file size
  49.               c = by description (number of downloads with GTAFDL)
  50.               
  51.               defaults to by alphabet if not given
  52.               
  53.      reverse: r = reverse order in output list
  54.  
  55.               When no outputpath is given outputpath = inputpath
  56.  
  57.  
  58.  
  59.  
  60. examples
  61. ~~~~~~~~
  62.    filesort file:ta/files.bbs
  63.  
  64.     - Sorts the TA file area list alphabetically and overwrites the original
  65.       file.
  66.      
  67.      
  68.    filesort file:ta/files.bbs ram:files.tmp
  69.  
  70.     - Will do the same except the output will be saved as ram:files.tmp and
  71.       the original files.bbs will not be overwritten.
  72.    
  73.    
  74.    filesort file:ta/files.bbs d r
  75.  
  76.     - Sorts by reverse date (newest files at the top) and overwrites
  77.       file:ta/files.bbs
  78.  
  79.  
  80.  
  81.  
  82.   Send comments, suggestions or bug reports to:
  83.  
  84.   Rod Schnell
  85.  
  86.     The Guild BBS 14400 v32bis, 240 megs    1-604-339-9805  Fido: 1:351/1114
  87.  
  88.